home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir34 / bkup10.zip / BK-HLP.BTM < prev    next >
Text File  |  1994-05-05  |  6KB  |  161 lines
  1. :: BK-HLP.BTM
  2. :: A HELP file for BKUP.BTM.
  3.  
  4. if "%1"=="name_text" goto name_text
  5. if %@index[%1,i] ge 0 goto help_i
  6.  
  7. :help
  8. cls
  9. screen 2 0
  10. text
  11.    BKUP.BTM
  12.    (1) Creates a compressed archive for [a] all or part of the files saved
  13.        today, or [b] since a specified number of days back, or
  14.        [c] since a specified date.
  15.    (2) (With the -x switch:) Extracts the archive(s).
  16.    
  17.    All default parameters for BKUP are configurable in BKUP.INI. However,
  18.    most parameters can be overridden from the command line. Aliases with
  19.    parameters different from the defaults is another way to avoid making
  20.    changes to any of the files in the BKUP package.
  21.    
  22.    When run with the -x switch, a selection screen will allow marking
  23.    files for extraction (with spacebar), or "point and shoot" (by putting
  24.    the cursor on the desired file and pressing ENTER).
  25.    
  26.    BKUP uses by default Katz's PKZIP/PKUNZIP, but can be told to use
  27.    ZIP/UNZIP, or UC2 (UltraComprtessor II) instead. There are, however,
  28.    still unresolved small problems with both ZIP/UNZIP and UC2. See
  29.    BKUP.DOC for more details.
  30.  
  31.    --> BKUP h (or ?) displays HELP screens. 'i' - USAGE screen.
  32.    --> Press now any key for USAGE instructions.
  33.  
  34. endtext
  35. pause >nul
  36.  
  37. :help_i
  38. cls
  39. text
  40.   USAGE for ARCHIVING:
  41.  
  42.   BKUP [<search_drive:> <archive_drive:>] [parameters] [options]
  43.     <search_drive:>  is the drive which should be searched for files
  44.     <archive_drive:> is the drive where the archive should be created
  45.  
  46.   Parameters are:  [ n|-sMM-DD-YY ]
  47.      'n' stands for 'number of days back from today'.  For example, 'BKUP 3'
  48.          will create a list since three days back from today's date.
  49.      's' (or /s or -s) stands for 'since', followed by date, in the
  50.          MM-DD-YY (month-day-year) format. For example: BKUP s01-29-90 will
  51.          create a list for files created since 29 January 1990.
  52.  
  53.   Options are:     [ /pkzip|/zip|/uc ] [ /x file(s) file(s) ...]
  54.          '/pkz'                select Katz's PKZIP and PKUNZIP (Default)
  55.          '/zip'                select free ZIP and UNZIP
  56.          '/uc'                 select UC2 (UltraCompressor II)
  57.          '/x file(s) ...'      list of file(s) for exclusion
  58.  
  59. endtext
  60. inkey /K"ND[ESC][Enter]" ==`>` Press :n ENTER   -   for instructions on EXTRACTING archivesn N       -   for reading on giving your computer a namen D       -   for default parameters and examples n ESC     -   quit %%rep
  61.     if %rep == %@char[27] cancel
  62.     if %rep == @28 goto extract_h
  63.     if %rep == D goto defaults_text
  64.     if %rep == N goto name_text
  65.  
  66. :extract_h
  67. cls
  68. screen 3 0
  69. text
  70.   USAGE for EXTRACTING archives:
  71.  
  72.   BKUP -x|/x|x [<toupdate_drive:> <archive_drive:>] [options]
  73.   where
  74.       <toupdate_drive:>  is the drive to extract TO.
  75.       <archive_drive:>   is the drive to extract FROM.
  76.       If no drives specified, defaults are default drive ("to")
  77.       and B: ("from")
  78.       
  79.   Options are: [ /pkz|/zip|/uc ] [ /x file(s) file(s) ...]
  80.  
  81.       '/pkz'            select Katz's PKZIP and PKUNZIP (Default)
  82.       '/zip'            select free ZIP and UNZIP
  83.       '/uc'             select UC2 (UltraCompressor II)
  84.       '/x file(s) ...'  list of file(s) not to be extracted
  85.  
  86.    For full description read BKUP.DOC.
  87.  
  88. endtext
  89. inkey /K"YND[ESC] [Enter]" ==`>` About "name giving" press ENTER; D for defaults and examples;n    ESC to quit. %%rep
  90.     if %rep == %@char[27] cancel
  91.     if %rep == @57 .or. %rep == @28 goto name_text
  92.     if %rep == D goto defaults_text
  93.  
  94.  
  95. :name_text
  96. cls
  97. screen 2 0
  98. text
  99.      COMPUTER "NAMES"
  100.      ================
  101.  
  102.      BKUP is set to use the labels of your "search disk" and "extract disk"
  103.      (both of which would normally be your default drives) as "names" for
  104.      your computer. This makes it possible to know which of your computers
  105.      has/have been updated, and to which computers the archive has been
  106.      extracted (if there are more than one archive, BKUP will add all of
  107.      their names when the archive was extracted).
  108.      
  109.      You can change this default by entering a different name for your
  110.      computer at the 'compuname=' line in BKUP.INI.
  111.      
  112.      If your default drive has been given no label, BKUP will prompt you
  113.      to give your computer a temporary name for the current session. You
  114.      can make this "name" permanent by labeling your hard disk or typing
  115.      a name at the 'compuname=' line in BKUP.INI.
  116.  
  117. endtext
  118. if .%compu=.on (pause^quit)
  119. :: (return to bk-prams)
  120.  
  121. inkey /K"YN[ESC][Enter]" ==`>` Press Enter to continue; ESC to quit %%rep
  122.     iff %rep == %@char[27] then cancel
  123. elseiff %rep == @28 then goto defaults_text >&>nul
  124. endiff
  125.  
  126. :defaults_text
  127. cls
  128. screen 1 0
  129. text
  130.       BKUP "BUILT-IN" DEFAULTS
  131.       ========================
  132.       If BKUP is run without any parameters and options, it will use
  133.       the defaults defined in BKUP.INI. If BKUP.INI is missing,
  134.       BKUP will use its "internal" defaults.
  135.  
  136.       The PRIMARY defaults (for both compressing and extracting) are:
  137.       (1) Disk from which files will be compressed - default drive
  138.       (2) Drive where archive will be created      - B:
  139.       (3) Disk to which files will be extracted    - default drive
  140.       (4) Drive where archive will be looked for   - B:
  141.       (5) Compression and extraction programs:     - PKZIP and PKUNZIP
  142.       (6) Date for files to be updated:            - today
  143.       (7) Exclude files:                    -  *.zip *.bak *.tmp *.log
  144.  
  145.       Therefore, if you just type "BKUP", this is equal to typing:
  146.       
  147.       (compressing:) BKUP c: b: 0 /pkzip /x *.zip *.bak *.tmp *.log
  148.       (extracting:)  BKUP -x c: b: 0 /pkzip /x *.zip *.bak *.tmp *.log
  149.  
  150.       For an explanation of SECONDARY defaults see BKUP.DOC.
  151.  
  152. endtext
  153.  
  154.  
  155. :help_p
  156. inkey /K"HP[ESC][Enter]" ==`>` Press Enter or ESC to quit, H for first HELP screen %%rep
  157.     iff %rep == %@char[27] .or. %rep == @28 then cancel
  158. elseiff %rep == H then goto help
  159. endiff
  160. :: =====end HELP====
  161.